Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Low-Level Movie-Editing Functions

InsertEmptyMovieSegment

The InsertEmptyMovieSegment function adds an empty segment to a movie. You specify the starting time and duration of the empty segment to be added. These times must be expressed in the movie's time scale.

pascal OSErr InsertEmptyMovieSegment (Movie dstMovie,
                                       TimeValue dstIn,
                                       TimeValue dstDuration);

dstMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

dstIn

Contains a time value specifying where the segment is to be inserted. This time value must be expressed in the movie's time scale.

dstDuration

Contains a time value that specifies the duration of the segment
to be added.

DESCRIPTION

The InsertEmptyMovieSegment function then inserts the appropriate amount of empty time into each of the movie's tracks. The exact meaning of the term empty time depends upon the type of track. For example, empty time in a sound track is silent.

You cannot add empty space to the end of a movie. If you want to insert a segment beyond the end of a movie, use the InsertMovieSegment function, which is described in the previous section.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidDuration	-2014	This duration value is invalid
invalidTime	-2015	This time value is invalid

Memory Manager errors